home *** CD-ROM | disk | FTP | other *** search
/ Sky at Night 2011 January / SAN CD 1-2011 CD-ROM 68.iso / pc / issueMedia / Software / AviStack2 / IDL70 / help / widget / pwidget.txt < prev    next >
Encoding:
Text File  |  2007-11-08  |  4.2 KB  |  119 lines
  1.         PWIDGET - Basic Plotting Widget
  2.  
  3. PWIDGET is a basic widget to produce simple plots.  It allows easy
  4. customization and annotation via a point-and-click interface.
  5.  
  6.  
  7. PWIDGET is called with the vectors to plot as parameters.  N
  8. observations of M variables are displayed with the call:
  9.  
  10.     PWIDGET, x, y
  11. Where: 
  12.     x = an optional N element parameter, containing the X value of each
  13.         point. 
  14.     y = an (N, M) vector containing the ordinate values for each
  15.         point, for each variable.
  16.  
  17.  
  18. The parameter settings may be saved and restored in a structure via
  19. the SAVE and RESTORE keywords. 
  20.  
  21.  
  22. ************************* Operation ***************************
  23.  
  24. ---------------Top row buttons:
  25.  
  26. Done - exits PWIDGET.
  27.  
  28. Reset/All - Resets the scaling, line settings and colors to their
  29.     original default values.
  30. Reset/Annotation -  Clears the annotation list which contains 
  31.     arrows, boxes, text, and legends.
  32. Reset/Redraw - Redraws the plot.
  33. Reset/Scaling - Restores the scaling to its original value.
  34. Help - Prints this text.
  35. Print - Makes a hard-copy of the plot on the selected output device.
  36.     The name of the output file for PostScript is idl.ps, for HPGL
  37.     it is idl.hp, for LJ-250 it is idl.lj, for PCL its idl.pcl,
  38.     and for CGM it is idl.cgm.  The file is not closed, so that
  39.     multiple plots are placed in one file.
  40. Hide Controls - Removes the controls from the screen and displays only
  41.     the plot.
  42.  
  43.  
  44. ---------------Mode buttons:
  45. General - Displays the general main control panel.
  46. Title - 
  47. Sub-title - Enter the text for the main plot title and sub-title here.
  48. Nsum - The number of points to average for each plotted point.
  49. Tick Style - Selects the tick style of the plot.
  50. Bkgd - Selects the background color of the plot.  Click on the desired
  51.     color or shade.
  52. Char Size - Selects the size of the characters.  
  53.  
  54. ---------------Line Box:
  55. This control box selects the name, color, linestyle, thickness, marker
  56. symbol and marker size for each variable.  Press the variable's button
  57. to select the variable.  To change the name of the current variable,
  58. enter the new name, followed by a Carriage-Return  in the Name widget.
  59. Variable names are used when making legends.
  60.  
  61.  
  62. ---------------Mouse Movement:
  63. Moving the mouse over the plot displays the coordinates in the lower
  64. left control.
  65.  
  66. To zoom a region of the plot to fit the entire window, select a
  67. rectangular region by clicking the middle mouse button on one corner
  68. and dragging the mouse to the diagonally opposite corner.
  69.  
  70. To pan the plot, drag the mouse with the left button down in the
  71. direction of the movement.
  72.  
  73.  
  74. ---------------Axis Boxes:
  75. X Axis button - Displays the X axis control panel.
  76. Y Axis button - Displays the Y axis control panel.
  77.  
  78. The type, style, title, range, and margins for each axis are
  79. manipulated by this control box.  In general, controls are self
  80. explanatory.  If the default values are not appropriate, enter the
  81. desired value into the respective text widget followed by a
  82. Carriage-Return. 
  83.  
  84.  
  85.  
  86. ---------------Annotation Box:
  87. This control box allows the addition of arrows, boxes, text, and
  88. legends to the plot.  Select the appropriate type of object by
  89. clicking its button.
  90.  
  91. To draw:
  92. Arrow: select the arrow mode.  Then click where the tail of the arrow
  93.     should go, and drag the mouse with the button down to the end
  94.     of the head.
  95. Box:   select the box mode, and drag the mouse with the button down
  96.     from one diagonal corner of the box to the other.
  97. Text:  enter the text in the Text window.  Click on spot where the
  98.     text should go.
  99. Legend: draws a box containing the variable names, and their line
  100.     patterns.  Select one corner, and drag the mouse to the
  101.     diagonal opposite corner of the legend's box.
  102.  
  103.  
  104. Controls:
  105. Undo Button:  removes the last object.
  106. Coordinates/Data:  objects are located by data values.  Changing the
  107.     scaling will move the object with the data.
  108. Coordinates/Relative: objects are located at a specific point on the
  109.     screen.  Changes in scaling do not move the objects.
  110. Box Background: Selects between erasing the area underneath boxes, and 
  111.     leaving it unchanged.
  112. Text: Enter the text for the annotation here.
  113.  
  114. The remaining controls affect the color, thickness, character size,
  115. and text alignment. 
  116.  
  117.  
  118.  
  119.